deleteImage

Type

message

Summary

Sent to an image just before it is removed from the stack.

Syntax

deleteImage

Description

Handle the deleteImage message if you want to perform cleanup before an image is removed from the stack.

The actual deletion is not triggered by the deleteImage message, so trapping the message and not allowing it to pass does not prevent the image from being removed.

However, the undo command will restore an image after it is deleted by the user. For example, the following handler, placed in a card or stack script, effectively prevents an image from being deleted by the user:

    on deleteImage
        beep
        send \"undo\" to this card in 5 milliseconds
    end deleteImage

Examples

on deleteImage
  export the target to file "Saved"
  pass deleteImage
end deleteImage

Related

property: script

command: delete

control structure: pass

glossary: handler, trap, message, command

keyword: card, image

object: stack

Compatibility and Support

Introduced

LiveCode 1.0

OS

mac

windows

linux

ios

android

Platforms

desktop

server

mobile